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this document describes the program "TEX*®, the TCS Master program 
toa the T2000 computer. 


swhetal into about TEX 


X*" stands for "Tos EXecutive". 


TEX 13 the TCS master program tor the first release of the 
VC2UUO Computer, implementing a subset of the full Tes 
Waster! s features. 


RX provides power on/off, reset, buctatrap, 
examine/depostt and TTY simulation tuncthons, a3 well a3 
Mirect access Co the low-level TCS slave functions, It 


Walns routines to scan the system comtiyuration and 
to tet 


Met that information to the operating system software. 


VEX provides a "cunsule terminal” for the operating system 
hunuing oh the PCsvvu Computer, Chatacters ate passed between 
the TCS! s Consele and butters in the TCL000 computer’ s memory. 


we the sectlun "How TEX runs th S2U0U system" for 4 
discussion of TEX!s operation and how it relates ty Che 
PCouUU operating system, Alsu, gee Che sectlu “Power-on 
Servicing features®™ tur tntormation on TEX! s support fur 
servicing the T2000, 


VEX provides a number of services to the operating system at 
AUS request. These allow the operating system ty control 
halting, reloading, recontiyguring and monitoring of the 
buttortly 2 hardware. 


VEX algo cuntatos some initia) diagnostte rvuttnes fut 
testing a TULv0U processur tude and Lor settling boatd 
reviston and sectal number information, Tt ta expected that 
these functions will eventually be moved vat of TEX and into 
other programs used by manufacturing. 


VEX ts written dn C, complied using Micresott © and sun's 
PC-NFS, with sources on our Sun servers. At present, the 
Sources and this document reside in 

Just /bt ly2/sre/tces-m/tex/rel. 


TEX 13 loaded trom a haid disk of a tloppy disk, running 
under MS-DOS or PC-DOS. 


The user interface to TEX 1s via a menu system which is 
essentially the same as that used tn other Te2v00 system 
diagnostic suftware. 


TEX takes Commands from the consvle Cerminal of the Tes 
master, This can be elther a PC-style keyboard and 
display or a serial terminal on the TCS master’s COM 
port. A separate device difver (SDKIVER.S 


Phe ear tal pert and mew 


5) Limp dement 3 


t interface. 
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TEX will execute a script of commands from a file It that 
file’s name is included on the DOS command line which 
Starts TEX. Additionally, TEX will execute a script file by 
using the DOS {nput redirection mechanism, t.e., 

“tex < file" or by specifying the command file to a 
futility Do™ command within TEX. 


TEX provides calendar time service for the T 


2000 computers 
operating system, Since the DOS operating system dues i 
properly deal with daylight savings time, TEX requires that 
the TCS master’s calendar clock and DOS Limes be in UTC 
(ar). 


Some agditiongl features are yet to be implemented, As they 
yet done, this document may therefore be Jncomplete. 


tnvoking TEX trom the command |ine 
VEX Cakes a few switches on the POS command | tue. 
The switches can be typed ag any unique abbreviatson or 


thelr full names, 


-Autobvel causes 


X to autumatteally toad the boot st ray 
contigutation rile BOOTLEG, 
tile SLOTCEG.TCS before executing any other commands. 
These files configure TEX for a particular installationts 
hatdwWare and operational chatacter!stios. They are 
described in detall ina later section, TEX than begins 
tO operate the system ay deseribed for the “Appi tcation 
kun conmand. 


CS and thes 


ot cont byurat bon 


' “Menu and -NoMenu control whether Che menu system 
displays menus to the user. -Menu, the default, 
1s equivalent to specitylag the commands "Terminal 
Hardcopy” and “Terminal Menu-On -NoMenu turns 
menu displays off, and 1g equivalent to "Terminal 
Hatdcopy” and “Terminal Menu-Ort*. 


-TCS-Addr tollowed by a hex umber sels the default slave 
address. This 1s equivalent to the "Utility Slave® 
command at the TEX command level, but 1s provided for use 
in batch tiles. 


-help prints out the list of these command line switches. 


A tilename may also be specified on the command Hine, This 
will Cause TEX to execute the commands in that tlle a3 ita 
Utility Do filename" had been entered, before executing any 
other commands from the keyboard (or trom any redirected 

' input stream) . 


Commands ty TEX 


The user tt 


ettace to TEX 13 through a menu system, 
The status Mine of most menus 1s: 


fC2000 TEX[x.y.2] version neunin® 


wx.y.2" da the current default TCS slave addeess and tH unit 
ts the version number of thls copy of TEX. When start 
mand prompt of 


displays the toypcdevel menu and a 
Th. prompt: changes to Include the name of Che current wena 
ted. Typing question mark - carelage 


when a sub-menu fs sele 


teturn will produce a list of the available commands or 
sub-menus at any point. 


Commands may be entered by typing elther thelr name or their 
Humber a3 shown on the current menu, Names may be shortened 
to any unique abbreviation, often (but not always) a single 
letter. 


Selecting a particular command ty done by entering the names 
of any submenus between the current menu and the desired 
command. For example, from the top-level TEX menu, the 
“Blink® command 13 reached via the Intermediate "Hardware® 
submenu, ‘The command would be entered a3 "Hardware biink" 
{or just *h L*) from the Cop menu, Lt would be entered as 
*blink® (or just "b*) from the bardware menu, If the desired 
command $3 not tn the current menu or its submenus, the 
command can still be entered by preceding it with a %/* 
Character, Pur example, "/h Lb" could be used whtle the 
urtent menu fs the "Memury™ submenu. 


In this document, command nates will 
foperlevel menu is the current menu. 


shown a3 tt the 


When numbers are supplied a3 argun 


ts to commands they: 
etme! numbers must 
be specitied by preceding the number with "x", That 
(a, the number 16 decimal may be spect tied” 
“Lem or ax "0x10", 


ste aysumed to be dn dectmal.  Hexad 


elther a3 


sed addresses 


Many of TEX! s Commands refer to a specttic Te2vvu card 

boa ytuup of catds. dn the descriptions below, the Cen 

®oatd address® Means a description of this address st ygument 

tua TEX command. The af Scand address” iy 
jroup of Uhtee numbers separated by duts. For example, the 
sommand *Hatdware blink O /.u.1" turns off the yellow LED on Che 
pivvesser node catd which bs lvcated fn bay V, midplane 0, 

slot 1 oof the machine. 


lest case of ao 


The thitd tleld of a 
alsu refer to a swite 
RA, KB, CA and CB refer ty the "A™ aid Mb" Switch 
cards, Switch Requestor cards and Clock geherator 
For example, the command “Hardware blink 0 7.1.RA® Curns off the 
yellow LED on the Requestor card of the B switch in bay 7, 
widplane 1. 


wid adincso, the 


UE Chuck Card, 


For the clock cards, the bay and Midplane thelds should be 
ouwitted. For example, the command “Hardware biluk 9 CAT 
turns off the yellow LED on Clock card A, 


‘he third tleld can also be replaced Ly the letter "y" and 4 
hex number from U Lo FF. This means to use a target address 
containing a "Group address" as defined in the TCS slave 
documentation. The command “Hardware Blink 0 G4" sends 4 
Command tu all slaves which respond to ygivup dddress 4 
(normally all processor nodes). The spectal address "ALL" 1s 


fecugnized a3 Lhe “breadcast™ group address. 


Card addresses can also contain “wits cards", These cause 4 
Command Uo be lepealedly executed fur each vt 2 number of 
addresses In succession, For example, “Hardware Blink 0 
pertorns a "Hardware blink U* command for each 
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existing node in bay 6. And the command "Hardware Blink 0 
*.4.RB" turns off the yellow LED on each existing Switch 
Requestor card connected to switch & of the machine. The 
wslots® *C**, "R** and *S** mean both A and B clocks ot 
switch cards. 


In the preceding paragraph, “*existing™ means that a card 
was mentioned in the slot configuration file or that it 
has responded to a message from TEX since TEX was started. 
This speeds operations up by skipping cards which are not 
actually in the machine. [f the *** 1s replaced by a “!", 
however, the wild card will be taken to include all cards 
In the described range, even If Chey have not been heard 
from and are not in the slot configuration tile. 


Finally, a card address can also be an arbitrary four-digit 
hex number in the range OOvU-7ftf. ‘This number will be 

placed tn the two address bytes of the TCs slave messages. 
Vhis ts useful ror Lesting TCS slave tuplementations., The 


ver *S907", tor example, $3 he sume as the catd address 
Sh LTE. 


89/07/07 


13:56:53, texdoc 


s. Write 
Mouu summary 6. guit-to-TEX-Menu 
This section Lists the submenus available trom the lop The TEX Configuration menu contains Commands which are 
level TEX menu, Next, the lower submenus and the used to control contiguration information about the 
individual commands are Itsted. Te2000 system, This Intormation yenerally resides In 

contiguration files but tt can also be mudifled in the 

Here 13 Che Cop-level TEX menu, Each entry 13 4 submenu VCS Master processur after the tiles have been read, and 
except for the Syult-to-bOs" Command. The submenus are muditied files can be wiltten, 
described in succeeding paragraphs. 


EX Configuration Write 


Menu: TEX 1. buot-Configurat ion 

Application 2. Slot-Contiguration 

Cont tguration 3. Quit-to-Wilte-Menu 
4. Hardware 
4. Memory The TEX Configuration Write menu contains commands to 
5. Slave update the two main configuration files. 
eo. Terminal-Type 
r Utdity Menu: TEX Hardware 
b. guit-tu-bos 1. blink 

2. Phas te 


Phe Mu Lt to Dk 


oman Causes TEX To exit to the bos 


$. 0 Frequency 


ypetating system. This should act be dune tn nucmal 4. Flest 
ypetation, becauoe TERS knowlodye of the current state 4s Ge 
et othe Pe oou system bs dbscarded when TEX quits. bo. Hale 
1. lnttlalize 
Menu: TEX Application 8. Margin 
1. Configuration 9. bDU 
. Bxamine-Card 10, Bows 
$.0 Flle-Select LL. Temperature 
4.0 King-Node 12. Voltage 
5. Mode 13. Quit-to-TEX-Menu 
6. kun 
1, System-Status The TEX Hardware menu contains Low-level comms which 


6. TTY access hatdwate teatures of the system. These commatods 
9. Quit-to 


“Menu control aid examine the vartous cards directly, ated Chey 
should be used with caution. Some of these commands can 


The TEX Application menu contiels Che normal operatbon of Ctush the TC2000 application if used tndiscrtuinately. 


TEX when dt ds supporting the Tess computer!s operat bog 
system ur any olber progtam whieh cuts Th a Te taoe Meuu: TEX Memory 
function catd (a3 Gpposed to tanning de the Tes Master 1. Deposit 
itself). ‘This menu contains th wihds fot setting ap 2. Disassemble 
ab application and Ils buotstiaps. Lt slay directs TEX 3. Dump 
Lo run that application and ft contalns commands Pot 4. Examine 
examining the state of the syst Wout dodividual 5. Load-File 
cards. 6. UBWalt 
1. Zero 
Menu; TEX Application File-Select 8. Quit-tu-TEX-Menu 


1. Application 


Fs The TEX Memory menu provides commands for reading and 
3. Ubout writing the memory of a T2000 function vatd. The 
Ye QULL-LU-Appl teat ton-Menu “Depuslt", “Load-File"™ and 7% 

with caution to aveld crashing the TEsvvU application. 


stu" commands should be used 


The TEX Application File-select menu contalns commands 
for selecting the three binary tiles used in funping the Menu: TEX Slave 


applivation, ‘The first two files ate those which 1. Read 


tnitialize the PCY0ve function cards. The third ts 
either the application or its bootstrap. 


Menu: TEX Contlyuration 


1. Card-Use 
Ze Fetyet 

3.0 Recont igure 
4.0 Scan 


2. Write 
3. Quit-tu-TE 


Menu 


The TEX Slave menu, through {ts Kead and Write submenus, 
provides access to all the low-level registers tu 

the TCS slave processurs vl Che system, It alsu 
provides gs to the nenvelut tle EEPROM storage 
within each TUS slave processor. 


Menu 


ee ere veenen 


0. 
The 
the 


nonvolatile EI 


TEX Slave Read 
Act ton-Regi ster 
EEPROM-Kegi ster 
Gat e-Array-Register 
Hardware-Reyl ster 
Card-Type 
Serital-Number 
AtlUwotk-RKev 
Electrical-Rev 

TC: lave-Rev 
Quit-to-Read-Menu 


TCS Slave Read menu provides commands to tead all 
registers In a TCS slave processor, Including the 
PROM registers which describe the card!s 


sertal numbers and revision levels. 


Menu: 


lo, 


the 


TEX Slave Wette 

Act lun-Regi ster 
EEPROM-Kegister 
Gale Ar ray-keyl ster 
Wardware-kKeylster 
Cards Type 
Sertal-Number 

Art wotk-Key 

Electr teal -Key 


TUS-5 LavesKey 
Quit stocWr Lemon 


Tes Slave Welte menu provides commands ty wette all 
registers in a TUS slave processor, tncluding the 


nonvolatile EEPROM registers which desertbe Che card’ s 


getial numbers and reviston levels. Th 


be used with caution to aveid crashing the applicat lon 


using the card. Serial number and reviston level tatormation 


should never be Changed except under strict reviston 
control procedures. 


4 
4 
b> 
6. 

ul 
8 
9 


The TEX Terminal-Type menu provides commands which turn 
the wenu display on and off and which select the particular 
terminal type being used. This allows the menu Interface 


EX Perminal-Type 
vT3on 

Virboo 

Sun 

x 

Pc 

Hardcopy 

Menu-On 

Menu-Oft 
Quit-to-TEX-Menu 


to correctly manaye the screen display. 


Menu: 


TEX ULility 
Do 


Trace 

UAKT= Init 
Version 
Quit-to-TEX-Menu 


$e Commands should 
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The TEX Utility menu t3 a catch-all for 
' commands for TEX. 


Menu: = TEX Utility Trace 
1, Driver 


2. Loader 

3. PhyslO 

4. RunESM 

Dd. Service 

6. Error 

7. Quit-to-TEX-Menu 


some overall control 


The TEX Utility Trace menu contains the Lrace-level setting 


commands. These ate yenerally used for 


tinding system problems 


by producing extra output as TEX operates. 


Ccmmand descriptions 


TREX 


Vhs 


Te 


TEX 


This section lists all of TEX’s conunands in groups according 


Lo the menu in which they are found, and alphabetlcally by 
thefr full menu path name. 


Application Conf tguration 


This command writes the configuration information for the 
system into the memory of the current slave (which should be 
@ processor, not a switch of clock card). The information 
Must have been previously obtalned, either by a 
Configuration Scan* command (see below) Of automat ivally as 
a tesult of an “Application Kun" command. This datormat lon 
is written tn a predefined turmat tn page UO of the 
Processor!s memory, The serlal number of the current: slave 
ts algo read from its TCS EEPROM and stored In the 
prucessur!s memory, 


Ih gutomatieo operation, the contiguration tnformation ts 
written to each nude after the microbust successfully 
volipletes and again before the application bootstrap starts. 


Application Bxamdne-Card 


Thia command produces a display of Information about the 
selected TC, 


tue Catd. The card’s type, serial number and 
feviston levels ate aisplayed (from the EELKOM on the card). 


The current use, goal and state information ate alse shown, 


Application Plle-Select Applicat Lon 


This command spectties one of the tiles to be used by the 
PAppl he 
application program (ur ity bootstrap) and 13 losded into the 
King node after all nodes are Initfallzed. The tile must 
exist on the TCS master’s DOS tllesystem., This tlle 

13 usually named “BOOT. 8s". 


ation Run® command, This tlle 13 used as the 


Application Flle-Select vost 


This Command specifies one of the tiles Co be used by the 
“Application Run® command. This file {3 used a3 the Power-On 
Self Test (POST). It {3 loaded and run in every node atter 
the successful completion of the microboot program, The rlle 
must exist on the TCS master’s DOS fllesystem, This file Is 
usually named "POST.56". 


Application Flle-Select Uboot 


This command specities one of the files to be used by the 
“application Kun" command, This file {3 used a3 the 
microboot, It 43 luaded and run in every node after the TCS 
Slave Initializes the node. The fhle must extst on the TCS 
master’s DOS fllesystuu. This file ts usually nated 

*UBOOT. Bu". 


Application King-Node 


This command specifies the catd address of the king node, 
Which Js the master we vf a mulli-processut application, 
Wits newts will be used by functions of the "Application Run 
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TEX 


command. It specifies the node which will be loaded with the 
application buotstrap and polled four TTY characters and 
service requests, This command also sets the "default* TCS 
address, usually specified by the "Utility Slave" command, to 
Lhe same node. 


Application Mode 


The mode Command sels Lhe “system mode" which directs TEX's 
operation under the "application Kun® command,  Atter 
selecting the deslred mode, Che “Application Kun® command 
Must be used Co accomplish the selected operation. 


“Application Mode Idle" directs TEX to discover all catds in 
the system and to turn on thelr power and to tattialize them, 
but not te load any application program, TEX will cun the 
microboot and POST programs on processor nodes. 


"Application Mode application® directs TEX Lo first 
Initiolize the system a3 described under “Application Mode 
idle". Then it loads and cuns the application (or tts 
bootstrap) a3 specttied in the “Application File-Select a” 
command into the current *king* node as specttited by the 
Application King" command. The application bootstrap thle 
eclticd fa the bor 


and king node may also be 


"Application Mode boot ® directs TEX to halt all pre 
and the! 
43 des. 


syors 
tart the inittalizattlon and bovlstiap procedures 
ribed tor *Applicat ton Mode application®. 


Application Mude off" directs TEX tu halt all processors and 
then Curn off power to all processors, switches and Clocks. 


“Application Mode walt" sets the system and card goals ty an 
*"unknown® state. This can be used in testing to cause TEX to 
communicate with the current king node for TTY interactions 
but not to bring any other nodes up or down. 


Application Run 


The *Application Run® comuand places TEX in automat te 
operation as selected by the "Application Mode*™ command. 
Whfle running, TEX polls all cards in the system and br lugs 
them to the state defined by the current system mode. This 
Includes sending initlallzation commands to the TCS slaves, 
running the microboot and POST programs and loading the 
application buotstrap into the "king" node. TEX also acts as 
the console terminal for the current king node, once that 
node iy .perational, TEX polls for *service requests" trom 
the king node also, Service requests are described In a 
later section. 


For a more complete discussion of operation under the 
Application Run command, see the section *How TEX runs Che 
TC2000 system". 


The operator can return Cy the TEX command prompt by typlng 
the two characters **." 1f TEX Is acting as the consule tor a 
king node. If there $3 no tunning king node then typing 4 
contiul-C character will return to the command prompt. 


Yo send an arbitrary contiel character ty Che prosesset node, 
the escape sequence “sbackprime-cchare" sends a4 


Processor, enter two of them in a row. 


YoOouse the console terminal function without cunning Che 


state machines which Liing the system up, reboot it, or shut 


10 down, use the *tty® command, 


VhX Application System-Status 


Vee 


The *Application System-Status* command prints out the state 


ot the clock cards and any switch and processor cards. 
The states will depend on the current system mode and 
on whether Uhe cards have successfully been initial lzed 


and whether their bootstraps and POST have run, 


It the system 1s fn Sapplicat lon® mode and the processors 


have tinished all thefr booting operations the status will be 


“HAPLY*®, The king tude, Lf def ined, will be in state 
KING Nodes which fatled thei: inirt 
lattup testa Will be repurted aa S51Ck 


tization or thelr 


A *joul™ will also be reported for eas 


nocard, This ty 
detcruiued by Che systei’s current inde and by the current 
®use® of the catd (see the "Countiguratton Card-Use" comm 


Application tty 


This couwatd ehters Lhe conscle TTY protucul rut ine, 
vatng the current default slave ax specified by the 
wuctiity Slave™ command, NOTE: This 13 NOT necessartly 
the same node as the "King™ (or *Master") node, 


Characters ate passed to and trom the TC2u00U processor fuode 
at the detault address over the TCS bus, using ring butters 


In the processor’ s memury. The escape sequence to return be 
the TEX command scanner, 13 backprime-dot ("*.").  (Backprime 
fy un-shifted tilde on most keyboards, go this ts simblar to 
eUipels escape, but different, 30 that TEX can be run from a 


tip dine.) 


Yo send an arbitrary conttol character lo Che provessut node, 


the escape sequence “Cbackprlmerschar7® sends 4 


Control-<char> to the provessur. To send a back-prlme to Che 


processor, enter two of Chem in a row. 


MEX Configuration Card-Use 


This command sets the configuration *use* fleld for a card or 
group of cards. The *use® fleld then directs TEX's operation 
Under the *Application Run® command, The *use" for 4 card 1s 


defaulted to “system™ if it has not been set before Che 
application Run® operation starts, Use" can alsy be set 
by the BOOTCEG,.TCS tile when TEX starts up. 


The tollowitnhy values are detined fur the "use" fleld. 
OFE: Tella TEX to leave the particular card Curned 
otf and not to use It, This can be used fur a known 


detective card. 


Tells TEX ty turn the vard vn, but to leave 
dooff se that dt cannot tnteract 


mtecl-«chare to the processor. To send a back-prime to the 


td). 
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TEX 


TEX 


TEX 


with other cards in the system. This Is intended to 
allow power-on servicing of TC2UU0 cards. A suspected 
card might be marked "OFF* in Lhe BOOTCEG.TCS tlle 
abd then switched to "ISOLATE" Lo be serviced. 


SYSTEM: Tells TEX to use the card normally a3 part ot 
the normal system operation 


AUXILIARY: Tells TEX to use the card normally, except 
that it will not be reloaded on @ system reboot. This 
{3 intended tor nodes running under pSOS or other 
special applications. Typically, the node will be 
treated a3 "SYSTEM" usage until the operating system 
tells TEX, via a service request, to consider Che node 
as "AUXILIARY®. 


FORGET: Tells TEX to clear 1ty Tknowledye of the card! s 
usage. This {3 used tor testing. 


Configuration Forget 


This command clears Che configuration determined by 

“Conf lyuration Scant, "Couttyucation Use" and “Application 
Run® commands, 3o that it will be tecdiscovered by the next 
Application kun™ or "Contigutat lon Kecunt lyure® 
This command 1s useful when changing the BOOTCEG 


evimnand , 
25 tile. 


Contiguration Recoutigure 


This command causes TEX Lo re-read the two configuration 
tiles, BOOTCEG.TCS aud SLOTCFG.TCS. This 13 a quick way to 
restore the configuration variables after having made some 
changes. 


Configuration Scan 


This command causes TEX to attempt to contact all of the 
TCS slaves In the machine and to record and display what It 
finds. 


The argument selects the portion of the machine lo be 
scammed 1k *rile® is specif led, all cards mentioned in the 
SLOTCF 3 tile are scanned. It *large™ is specitted, all 
eight midplanes in all efyht bays are scanned, If *medtum 
13 specitied, all elght midplanes in bay 7 are scanned. It 
*small® is specified, only midplane 7 of bay 7 ts scanned. 


As the scan 1s done, the board type, serial number, and 
revision levels are typed out. The board types are also 
saved tor the "Application Configuration®™ command, see above. 


Coutiguration Wilte Boot-Conf iguration 
This conmand creates @ boot strap-time configuration tlle. 


the file used by TEX is BOOTCEG.TCS, but a different fle 
name can be used in this command to create other coples vt 


versions of the <. 
BOOTCEG.TCS Elle are described in detall in a later ge 


tiguration, The contents of the 


this command 13 typleally used a3 Tollows The existing 
BOOTCEG.TCS file fs read In, perhaps by 


Forget® followed by *Cont guration Reconfigure’. Then a 


Cont Igurat Lon 


TEX 


eutiguration item is changed, such as "Contiguration 
Card-Use OFF. Finally 4 few BOOTCEG 
Ly this command. 


Stile Js written 


Contiguration Write Slot-Conttgurat ton 


This Command creates a slot contiguration file. The tlle 
used by TEX fs SLOTCRG,TCS, but a different tile nam can be 
used in this command to create vther coples or versions of 
the contiguration. When TEX ts riest installed, a 
eConfiguration Welle-Slot slotety.tes® must be dune beture 
wulotihat be operation fs used. 


The slot configuration thle contalus the card address, card 
type, serial number and revision information about each card 
fo the system, The "Configuration Wrlte-Slot® command writes 
yuch a file, tucluding all cards whitch are presently known to 
TEX, due to a *Configuration Sean* or Application Run* 
command, and which are not disabled (by a *Configurat lon 
Card-Use OFF" Command Gr a "DisabledCards™ or "CardUse" Line 
Iu the BOOTCRG. TCS thle). 


Hotdware blink 


Vhs comand sets the *biinking® state of the yellow "PLAG" 
fudieatur on a card of group vf cards. The states ater O07: off 
glow blink 2: fast blink 3: on 


The Cubventtunal usage vf the yellow Leb ba: 
on: Not yet initialized of cannot be Initlalized 
Blinking: being initialized vi in need of service 
Ott: Operational 


Hardware Diagnost te 


This command runs one of a set of builtin diagnostle 
routines, Test number zero means to run all of the tests tn 
otder. The following tests exist: 


} Wilte/Read flouting U and floating | patterns Co the 
TCS slavels action reglster 7. This 1s 4 KAM 
register within the TCS slave provided for this 
purpose, to test the Master-to-Slave communivat Lon 
path. 


nN 


Write/Read floating 0 and floating 1 patterns to 
SIGA-A on the current detault slaves board. This 
test uses the data and address registers in the 

SIGA but does NOT Cause any T-bus cycles. This tests 
the communication path from the TCS Master to the SIGA, 


3 Write/Read floating 0 and floating 1 patterns to 
location zero (32-bits) of the ploucessor!s KAM, This 
tests the path from the SIGA through the T-bus to the 
RAM. 


4 Write/Read the values 0u through FF to locations 00 
through FF ot the processur’3 RAM. Then wrile/tead 
the Complement of those values. This Lests Che 
addressing of processor’s KAM, but only the low eight 
addtess lines. The TCS serial bus ts too slow to 
support a full memory Cest of this sor. 
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5 Test that the 88K processor Can be started and that 
it can access memory. This test loads a short 
program {nto locations 600-614 of memory, sets a data 
word at location 700, and sets the start vector at 
locations zero and four, It reads these words back 
to verify them, Then it starts the processor by 
teleasing the reset signal, waits brtetly and stops 
the processor. It then checks to see that the data 
at location 700 has been complemented by the 88K‘ s 
program as it should be. 


The actual program and data word 


000/ [0000180 br 600 

vua/ P4uv58vU or 1, £0,120 (nop) 

e0U/ 15av0700 Ld 110,10, 700 

604/ thoudsava xvr.e 11,10, 010 

eU8/ 25000700 st 111,140,700 

6Vc/ cO0UDV0U br bvE 

610/ f400560U or 10,120,120 (nop) (for pretetoning) 
614/ 14005800 or 10,160,180 (nop) (for prefetening) 
1uv/ 12345555 


Hatdware Frequency 


This comm 
the system, 


dotells TEX the frequency of the master clock for 


Yhe delaull Lrequency 1s 38 for a JB meyaherle Clock, The 
argument must be an even number within the range of the clock 
card. This number iy later used to tnitialize the clock (by 
“Hardware Initialize* or “Application Run®). 


The frequency 13 given to the TC2000 processor nodes (Ly 
"Application Conflgure™ or "Application Kun®) to allow them 
to initialize properly. These numbers may also be set by the 
BOOTCKG.TCS file. 


Hatdware Flest 


This diagnostic command exercises the TC/CLK card to determine 
the lock range of its phase-locked loop. The printout 
reports the results. The current default slave is tested; 

it must be a clock card. 


Hardware Go 


This command starts the currently selected TC200U processor node 
al the specified address. If the address Ls cere, the 

last start address trom 4 loaded file is used. This function 
operates by writing two words in memory at locations zero and 
four. The first is a br.n instruction to the start address. 
The second iy a load Instruction which sets register 62 lo 

the board’s nude number, from 0 through 51] decimal (itt 

hex). TEX then asserts a processor reset, walts brietly, and 
remuves the reset. The processor will begin by executing 

these two Instructions. 


Hardware Halt 


Halt @ processor node (ot yroup of Nodes). TEX dees thls by 
asserting the processur reset Line, but not the buatd reset 


Pex 


thx 


Hine, While the processor ds halted other commands may be 
pertormed, guch as examine and deposit and load. When the 
processor reset 13 removed, such as by the "Hardware Go* 
command, the processor will start at the reset vector at 
location zero. 


Hardware Intthallze 


‘he "Hardware Initialize* command performs a board-specttic 
Initialization sequence tor a processor nude, switch or clock 
card. The said address may have wildcards, 


For the clock card, the card ds reset and powered on and 
the phase-locked loup fa get to the frequency specitied 
by a previcus *trequency® Command (default 38 MHz). 


For the switch cards, the sequence 13 similar, except that 
the switch gate arrays are tnitiallzed and all efght 
function card ports are disabled. Switch cards should be 


fnithallzed before prosesser nodes. This sequence will 
leave unused switch ports disabled. Active ports are 
ehablod When the processor nodes are intttallzed, 


bor a processor node, TEX teads Che board status, Curns on 
the power, assetts processor and Lourd resets, and turns on 
the LED Diloker. Then it walts a while abd cotoves the buard 
reget, The processor remains halted. TEX then enables the 
switch path ta each LCON and sets the addresses vf wach SIGA 
bu thelr default) values. Finally it turns on Che switch 
path tor this node dn the switch cards that serve Lt. 


Hatdwate Margit 


Vhis command sets Che voltage margin logle on the spect tied 
card. The first argument detines the a 
tollows: 


tyin level as 


H - HIGH tlo® 
ho- high #58 


nho= bhottal 
do= luw  =5% 
L - LOW lus 


Note that this command inherently Curns ON the power for 
the card if it ds not already on. 


‘TEX Hardware PDU 


The "Hardware PDU* (Power Distribution Unit) command ty used 
to turn on or off the bulk power supplies tor the system by 
controlling the main power relays. 


The tirst argument 13 elther "on™ or "oft*. 
In a large system the PbUS are split: Into two groups, 
controlled by relays "1% and "2°, The second argument 1s 


either 1", *2"° of *bothe. 


It TEX 1s started with a command tile or with the *-Automat te® 
switch, it will turn on both PDUs when starting. 


thx Hardware Power 
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TEX 


TEX 


TEX 


Turn power on or off at a card or group of cards. | 
If *all® 1s used, a broadcast message 13 used to turn 
the slaves off. ‘Hardware Power On® 1s equivalent to 
“Hardware Initialize™. 


Hardware Temperature 


The "Hardware Temperature" command produces a report of the 
temperature found at the sensor or sensors on the spectfited 
card ur cards. 


Hardware Voltage 


The “Hardware Voltage" command produces a report of the 
various vellages within the specified card ot cards. The 
present reporting algorithm does NOT correctly use the 
calibration points stored tn the EEPROM on the cards. Thts 
will be Lmproved In a future release. 


Memory Deposit 


This Command performs one write Into the memory space of 4 
processor node, The Tirst argument Ly lb" or Mkt or “we for 
4 byte, halfword or word cycle. ‘This command may be executed 
while the processor fa halted of running. The address need 
hol be in the processor!s local KAM. Anything currently 
available to the T-bus may be written, though only 32 bits ot 
address are supported, 


Memory Disassemble 


This Command dumps an area of processor memory formatted a3 
MCB8100 Instructions, The atea starts at “address” and 3 
sword count™ words Lot *Word count" 13 truncated to 512 
words. 


Memory Dump 


This Command produces a hex dump of an area of main memory on 
the current slave, which should be a processor node (not 4 
switeh or clock). The atea starts at "address" and 1a 
*byte-count™ bytes long. “byte count® is Lruncated to 2048 
bytes. 


Memory Examine 


This command performs one read from the memory space of 4 
processor node, The first argument ta b oc h or w for 4 
byte, halfword or word cycle. This command may be executed 
while the processor 13 halted or cunning, The address need 
not be in the local RAM. Anything currently avallable to the 
{-bus may be read, though only 32 bits of address are 
supported. 


Memory Load-File 
This command loads a tlle trom the TCS Master!s DOS thle 


system into the curtent derault node, which should be 4 
processor (not a switch or clock). 


The loader can read both COFF and a.out format files. 
The header Information ts summarized on the ¢ 
and dots are printed as the losding proceeds (one dot 


sule 
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every Jb6 bytes). The default starting address for the 
“Hardware Go™ command 13 set from the file!s entry vector. |TEX Slave Read Card-Type 
The processor 1s NOT started by the "Memory Load-Flle* H 


This command reads a portion of the EEPROM on the currently 
comunand = 


you have to type Hardware Go*. This allows | selected TCS slave. This command reads the EEPROM byte which 
loading of multiple flles, and multiple nodes, before specifies the card type. 
starting the processor. 


TEX Slave Read Sertal-Number 
VhA Memory UbWalt 
This command reads a portion of the EEPROM on the currently 
Walt for microboot to finish. This command should be used tn Selected TCS slave. This Command teads the EEVKOM bytes which 
a script thle to allow the microbwot to finish, It knows specify the card’s sertal number. 
Where the microboot’s state register lives in the processur!s 
memory atid Lt moniturs that cell tor completion, (it will TEX Slave Read Artwork-Rev 
algo time out after a while fn case the boot tails.) 


This command reads a portion of the EEPROM on the current ly 


“Memory UbWalt* should be used to walt tor the microboot to tinish selected TCS slave, This command reads the EEPROM bytes which 
beture loading the next application or bootstrap program. specify the card's artwork revision level. 

VRS Mamory Zero VEX Slave kKead Elects foal-kev 
This command clears an atea of memery ta the current default This command reads a portion of the EEPROM on the current ly 
node. 10 witles words of gery into the specttied range (and selected TCS slave. This Command reads the EEPROM bytes which 
bytes at the edges dt the range fs tet word aligned). At specity the cards electrical revisdon level. 
TCS-bus speeds, this will be acceptuble tor a few K words, 
but will be slow for larger areas. (Ketember that the TEX Slave Read TCS-Slave-Kev 


mictubuot clears all of RAM.) 
This Command reads a portion of the EEPROM on Lhe currently 
IMA Dave Kead Act boun-Rey later Selected TUS slave. This Command reads Lhe ERPKOM bytes which 
| specity the card’y TCS slave processor code revision level. 
kead a TCS slavels "action register". The "action registers* | 
ate described in the PCS slave code document. This command VTEX Slave Welle Actlon-Kegister 
allows direct access lo these registers. The data fs one j 
Lyte wide. See the TCS slave documentation tur specitics. 


Wilte a TCS slave’s faction register". The “actton 
registers" are described in the 1 Slave code document . 


(RX Slave Read BEPROM-Rey ister This command allows direct access to these registers, The 
data 1s une byte wide. See the TCS slave documentation for 
Kead a TCS slavel3s EEPROM, The EBPKOM teylslers ate specifics, 
degeribed tn the TOS slave code document. This comunatid 
allows direct access to these registers. The data $s one TEX Slave Write EEPKOM-Keg/ ster 


byte wide. See the TCS slave decumentut ton toa specttios. 


Write a TCS slave's EEPKOM, ‘The EEPROM registers ace 


Note that the EEPKUM of a TC/SK Card 1s accessed by @ deseribed In Che TCS slave code document. ‘This command 
{itterent method, since the TC/SR dues not have a TCs slave allows direct access to these registers, The data 1s one 


Slave 7,0.RA® and try to do an eeprom access, but It would 


processor on It, | In particular, you could specity "Ucttity | byte wide. See the TCS slave documentation fur specifics. 
| 
not do the right thing. | | 


Note that the EEPROM of a TC/SR card is accessed by a 


| different method, since the TC/SR does not have a TCS slave 
Slave Read Gate-Array-Register ! processor on it. [ In particular, you could specify “slave 
| 7.0.KA" and try to do an eeprom access, but it would not do 
Read a gate array on the node or switch, The various boards ! the right thing. } 
address the gate arrays differently and the various gate 
atrays have differently sized registers. See the TCS slave Changing EEPROM registers which specify sertal numbers and 
documentation and the gate array documentation for specifics. revision levels should only be done under strict revision 
cuntrul procedures. 
VEX Slave Kead HardwWare-Keygister TEX Slave Write Gate-Atray-Keyister 
kead a PCS slave’s hardware port. The slave processors have Write a gate array on the node or switch, The varfous boards 


access ty sume direct 1/0 ports un the varlous boards. address the gate attsys differently and the various yate 
betalls vary among the boards. This command performs read arrays have differently sized registers. See the TCS slave 
the TCS slave ducumentation and the yate array ducumentatlon for specttics. 


vpetalions ty the *hurdware™ registers. Se 


eonte description tor spectties. 


VEX Slave Write Hardware-Reglster 


Write a 


slave!’ hardware port. The slave provessors have 
access to some direct 1/O ports on the various boards, 
Details vary among the boards. This command pertorms write 
vpetulions Co the *hardware® registers. See the TCS slave 
wie deseription tor specifics, 


WRX Slave Witte Card-Type 


This wand Weltes a portion of the EEPROM on the currently 
selected TCS slave. This Muahd writes the EEPROM byte which 
spectties the card’a type. 


Ibe Slave Wrtte Sertal-Number 


Mhis command modities the sertal number tleld of the ERPKOM 
In the selected TUS slave. 


Hibs SNOULU NEVEK bk DONE WITHOUT bhultie MANUPACTUK ING 
WhACK ING OF ‘THE NUMBERS t 


Whe serdal number bs a le hatacter text string and the other 
Pieigs ate Jechatacter text atiings. AL this wilting, Che 
fotmats fot sume of these sttings ate nut yet defined. the 
Hiware cdépects strings of letters, digits and hyphens, with 
ho blanks. The setial qumber string should be ta the form: 
Ke 59999 Wl to a digits. 
oltlngs ate padded with trailing spaces to rlil the 
two ut alxteen character: flelds in the EEPKUM, 


Where the "9999" way bet 


Note that this command dues mot yet provide a method of 
writing these values to the TC/SK The TC/SR has uo TCS slave 
Processor. The logle tu use the TC/S5 processor ty write the 
TC/SR EEPROM fs not) yet completed. 


YEA Slave Write Artwork-Keyv 
Vhis command writes a portion of the ERPROM on the currently 
selected TCS shave. This command wittes the EEPROM bytes which 


gpectty the card¢s artwork revision level. 


“HS SHOULD NEVER BE DONE WITHOUT PROPER MANUFACTURING 
TRACKING OF ‘THE NUMBEKS ! 


VEX Slave Write Electrical-RKev 


This command writes a portion of the EEPROM on the 
Selected TCS slave. This command writes the ERPRUM bytes which 
gpuctty the card!s electrical reviston level. 


currently 


THIS SHOULD NEVER BE DONE WITHOUT PROPER MANUPACTUK ING 
TRACKING OF THE NUMBERS! 


tEX Slave Write TUS-Slave-Rev 
This command writes a portion of the EEPROM on the currently 


selected TCS slave. This command writes the EEPROM bytes which 
specify the card’s TCS slave code revision level, 


SHOULD NEVER BE DONE WITHOUT PROPER K MANUFACTURING 
KING UF THE NUMBERS ! 


THIS 
VhAG 
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TEX Terminal-Type 


TEX 


PRX 


TEX 


This command tnforms TEX’s menu dnterface what type of 
terminal 13 in use so that it can properly malntatna the menus 
on the screen. It also allows the user Co turn the menu 
display on or off by means of the “Menu-On™ and “Menu-Ort” 
selections. 


Utility bo 
This command specifies a tlle ot commands tur TEX to 


execute. Any sequence of TE 
this file, one per line, 


commands may be put in 


ft a “dom file contains ancther “ULLLIty bo® command, the second rile 
will be executed, but the first tlle will not be resumed, 
That ia, “do™ flles canmut be nested, However, a "do" thle 
can be executed within @ REDIRECTED Command tile. Por 
example, If thie *scciptl® contain: 
Command b 
utility do seeipus 


then command 


2 will NOT be executed by a “Ubi Lity bo sor ipul 
conmand or by a *tex seripel® DOS command, but 
IU WILL be executed by a “tex < seripli™ command, 


Utility Slave 


p13 Command sels Lhe default tatyel TCS address for those 
commands which allow a default of which Lake no address 
argument. See also the "king" conmand, 


Utility Trace [Driver | Loader | PhysIO | RunkSM | Service | Erroc) 


This group of Commands sets various Crave printing control 
variables within TEX, Some of these traces produce masses of 
output; use them with caution, 


The driver" variable, tf non-zero, Causes Craces at the TCs 
command driver level. 


The *physto* vartable, If nun-zero, Causes (races at the TCS 
UART 1/0 level. 


The *error® verfable, If non-zero, causes tractug of some 
error conditions dealing with TTY emulation, (It 13 used 
for debugging. Its use may change in later versions.) 


The *loader® variable 13 bit encoded: The "1" bit prints 4 
sumuary of the loaded thle; the 2" bit prints Into on each 
esectlon® of the file; the 4" bit prints the value and 
addtess of each word of the tlle. 


The *runtsi 
the tinite state 
command . 


vatlable controls printing of state changes in 
hine logle of the *Application Rua* 


utility UART-Init 


This command causes the UART for the TCS serftal bus 


to be reinitiallzed. The argument specities the baud 
tate of the sertal tus, The default 13 “fast". The 


*slow™ argument 1s now obsolete. 
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|How TEX runs the TC2000 system 


VEX UCL Lity Version 


The version command causes TEX to print its version number | 


This section is an overview of the mechanisms used by TEX to 
and compilation date. 


operate the TC2000 system. [t is included as an aid to 
understanding and using the application and configuration 
control commands of TEX. 


i TEX deals with each processor (TC/FPV, etc), each switch palit 

(TC/SS and TC/SR) and each master clock (TC/CLK) as a 
separate task. Each card is represented internally as a 
finite state machine (FSM) with states such as 
*Unresponsive", "Initializing", "Happy* etc. TEX runs these 
Slate machines (and thus the system) when 1t has been 
commanded to do so by an *Application Run*® command or by 

‘ \ being started by "tex -Auto™ from DOS, 


The overall system mode, the usage of each card and the 
responses Lo mssayes sent by TEX to each card are the Inputs 
to the card state machines. 


As an example, consider a system being run normally but with 
ohe processor node disabled due to a hardware failure. When 
starting, TEX reads the two contigucation files, BOOTCFG, TCS 
and SLOTCEG.TCS, These tell TEX what cards should be In the 
system, whether any of them are to be disabled, which node ty 
to be the master node and what the overall system operation 
mode should be, For this example, the system mode will be 
“Application®., The card uses will be "System™ except for one 
card which has the use "Off" because it 1s defective. The 
*otf™ usage ts declared by a *CardUsc" Ine tn BOOTCEG. TCS. 
All components start in the *Unknown® state when TEX 1s 
Slatted, The desired state is "King" for the master node, 
"Happy" for all other working nodes and "Disabled/Oftt™ tor 
the detective node. 


This status information can be seen by using the "Applicat ton 
System-status" Command, which Lists information about all 
parts of the system, or by the "Application Examine-Card* 
command which give more Infurmation about Individual cards. 
These Commands show the current state, the usage and the 

| desired state (goal) of each card. 


As the system 13 brought up from a cold start TEX initlallzes 
the clock card(s), then the switch card(s) and finally the 
processor cards, Initiallzation involves a sequence of 
states, to achieve parallelism. TEX can be loading the 

| microboot inty one node while others are executing the 

| microboot, for example. Finally, after all nodes have either 


completed or falled thelr microboot and POST operations, the 
application file (typically B00T.8@) 13 loaded tnto the 
master (King) node and started. 


Any cards which fail to inittalize properly will be put tato 
H a "Sick/On" of "Sick/olt™ stale, though thelr usage will 
| still be "System™ (or whatever was specified by the 
| BOOTCEG.1CS file). 


| The known defective card whose usage ig "Orr" will be put in 
the "Disabled/Off™ state. All “Sick* of "Diasabled™ cards will 

| be so marked in the configuration array that TEX passes Co 

' the application, 


' The operator and the operating system can cach change the overall 


gystem wode aod the usage of Individual cards tu control TEX's 
actions, The operator does this by using the “Application Mode* 
and “Configuration Card-Use" commands. Of course, the operator 
can use any number of lower-level commands Uhat can affect the 
operation ot the system, disrupting TEX!s operation. For example, 
@ "Hatdware Power Off" Command will turn off a card lamedlately, 
regardless of the system mode and card usage. Also, changing a 
card!s usage should not be done unless the operating system 

Jy capable of withstanding the change. A node being used 

by the operating system should not be switched to usage "Ori" 

cur "Isolate*® without shutting down the operating system. 
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Power-on Servicing features 


| 
| 
| 
| 


As described in the preceding section, TEX has two Tuse" 


values for cards to support maintenance and servicing. These 
are "Off" and "Isolate". 


The system administrator, upon determining Chat a card 
appears to be defective, should mark Uhat card's use 43 
*off*. If the system configuration without that card is 
useful, it can then continue to be used until malntenance 13 
scheduled. 


The system administrator should mark Uhe card as "Off dn Che 
BOOTCEG.TCS file. This is most easily done by the following 
sequence (using abbreviations, of course, Instead of the 
tollowing tully-spelled examples): 


) Shut down the 


stating system (nocmally unavoldable 
when a bad card causes a system crash). 


2) AL the TEX prompt, enter "Couflguration Forget". 


3) Enter "Contfguration Recoufiyure". This resds a fresh 
copy vf the BOOTCRG.TeS tile. 


4) Enter *Contigurat lon Card-Use OF n.n.n® Co disable 
the particular card, substituting its addvess for 


nent, 


5} Enter *Cont igurat fon Write b t-Contiyurat bon BOOTCES .T 
to overwrite the configuration tile. 


(Altermatively, an editor can be used tu manually edit the tle. 


Now the system can be restarted by entering *Applicatton Mode 
boot" and “Application Kus 


The system will come up with 
the detective nude disabled, 


When service personnel attive, the defective node cat be 
teplaced and Ube new node tested by entering a *Contlyuratlon 
Catd-Use Isulste™ Command, This will cause the card to be 
turted on but to have Its switch path lett off su that Lt 
cannot interrupt the operating system, The card can be 
tested by commands such a3: 


wutLlity Slave nen.n™ (ty select the card), 
“Hardware Diagnostic 0* to run the TEX-based dlaynusties, 
“Memory Load \path\file.88" to load a diagnostic tlle, 


“Hardware Go* and "Application TTY" to talk to that dhagnoath , 


atid su on, 


When testing Is dune, the card should be halted and 1 
should be switched back to normal operativa by "Hardware 
Halt" (while the current slave fg atill the new card), then 
eUtLlity Slave 7.7.7" (or whichever node 1g (he master) aud 
Application Run®. 


Finally, the new card can be brought lute servive at the next 
Scheduled system shutdown by using the same procedure which 
marked the card a3 “O0rf" to mark It a3 “System™. [TE the 
operating system can dynamically accept new f 
card can be made avallable immediately by the *Contlyurat lon 
Card-Use System a.n.n™ command, This ty not yet possible 


gsors, the 
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under the current TC2000 operating systems. ] | 


‘Configuration filles 
It should be noted that while TEX 1s NOT running the system 


(i.e., from the typing of "*.*" to begin the maintenance work 
until the *Application Run® command at the end) TEX will not 
be performing consvle TTY activity, will not respond to 
service requests from the operating system and will not run 
the state machines for all the cards in the system. If this | 
iy done while the system ts running and stable, the operating | 
system will survive this but some console output 13 Ilkely to | SLOTCEG.TCS 
be lost. [ 


read at startup if the -Autoboot switch 1s included on the 
DOS command line. These are SLOTCFG.TCS and SOOTCEG.TCS tn 
the current directory. These files are described in the 
next two sections, 


| There are two configuration files which TEX will automatically 


The slot configuration tile, SLOTCFG.TCS, contains 4 

description of the cards which should be found tn the 

' machine. Cards listed here will be Included In the expansion 
ot -type wildeards a3 arguments to TEX commands, For 
example, the command “Hardware Temperature *.*,*" will report 
the Lemperature of all nodes which are listed In this tlle. 
This allows TEX to avold polling cards which sre not going to 
respond. Similarly, the “Application Kun* command, whlch 
fnitializes all cards In the machine, expects to find the 
vards in this tile. 


The tlle contains one line for each card. The card’s card 
addtess, type, getial number and revision levels ate 
{ncluded. Discrepancles of serfal numbers and the Ike are 
reported If TEX notices them, This tile ts written by TEX, 
by the *Contiguration Write Slot-Contiyuratiou* command. It 
should not be edited manually. 


When TEX 13 started with the -Autoboot switch, de will report 
missing or extra cards, and {t will report cards whose typ 
gettal numbers or revision levels are different from those In 
this tile. 


BOOTCEG . TCS 

| 

| The bootstrap configuration file, BOOTCFG.TCS, gives specttiec 
parameters which guide the bootstrap process, Different 
versions of this file may be kept in different directorles, 
such as for production operation or testing. 


BOOTCEG.TCS tells whether to automatically bring up the 
operating system. It specifies cards which should be 
disabled, that 1s, which should not be initialized even tt 
they are present, It specities the preferred switch and 
clock in a redundant system. It specifies the microboot, 
POST and application bootstrap files. And It specifies the 
primary and secondary nodes for booting the operating system, 


The specific commands allowed in BOOTCFG.TCS are deseribed 

below. Each command consists of the command’ s name followed 

tnwediately by a colon, optional spaces, and the argument. 

Lower case and upper case are equivalent. For example, 
"AlternatePaths: A: Yes" 


AllernatePaths 


The AlternatePaths command takes tWo arguments. The first 
iy "A" or ®B® and the second 13 "Yes" or “No™. This 
Intorms TEX, and the initialization programs, whether 
alternate paths in the Butterfly switches should be 
used, The default Is to use these paths. Some protetype 
aystems, or defective systems, may run with Chese paths 
disabled. 


Aut sboot 


The "autobvot™ command takes one argument, a Y or an N, 
tf "Y* ts spectfled, TEX will automatically buyin 
running the system after reading the configuration tiles. 
If °N" ts spectfled, TEX will walt for commands trom the 
cvunsule after reading the configuration flles. 


boot tile 


The ®bootfile®™ command takes one argument, a filename for 4 
tlle om the TCS master’s disk. This fle will be run on the 
king node after Ube mleroboot and POST have been run on all 
nodes. 


boot Param 


Yhe "bootparaw" Command Lakes Cw arguments, both dec tinal 


hombers. The tirest number selects one of sixteen bootstrap 


parameter variables. The varlable 13 get to the second 


tute The use ot these bootstrap varlables ta desotibed 


foothe “services® section of this document. They are 


piovided Co support the operating system bootstrap. 
Pooteta thy 


Mhe *hyotsteing" Command Cakes the test of Che line (after 
the *houtstrings") as a string argument. TEX makes no use ot 
this strdog; It stmply holds 1t for 
spplication buctstrap. A typleal string bs 
*oxyu, 0,0) /vmunix® 


seoby the the 


wedge 


Yhe "cardugse” Command takes two atguiwents, a catd group 
address and a "use" definition, The Tuse" may be vie 
of Msystem", "auxiliary", “isolated*, of "otf, See the 
eContiguration Card-Use" command tur further detalls. 


Di vabbedvards 


he *disabledcards® command Lakes one atyuitent, @ catd 
address, possibly containing *!*-type wildcards. There may 
be multiple “*disabledcards” conunands dm the BOOTCEG.TUS tile. 
Each card named in a “disabledcards” cunumand will be marked 
with *Use OFF" (See the "Configuration Card-Use" command) , 
meaning that it will not be brought up automatically even 
though it may respond to TCS probes and may be present in the 
SLOTCEG.TCS fille, 


Poste tbe 
The *postfile™ command takes one argument, a filename for 
a tile on the TCS master’s disk. This tlle will be run 
on each node which successfully completes Che mivrobout . 
PrimaryC book 
the *primaryclock" command takes vie atguiment, ab A vt a B. 


This specities whether TC/CLK card A or B fs to be used 
ft both are present and working. | Hut yet binplemented. | 
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The *primarynode" command takes one argument, a specifle card 
address. This specifies the node which will be used for the 
application bootstrap (bootfile command) if it 13 working. 

This node ts also known as the "King™ node or "Master™ node. 


PrimarySwitch 


The "primaryswitch™ command takes one argument, an A or a By 
This specifies which buttertly switch ts to be used 
If both are present and working. [ Not yet lmplemented. | 


Seconda ryNode 


The *secondarynode* command takes one argument, a specifi 
catd addtess, This specifics the nude which will be used fur 
the application bootstrap (boottlle command) If the primary 
node is not working. | Not yet: luplemented. | 


‘olumns 


The *switchcolumms"” command Cakes one argument, a dec tinal 
fumber. This is the number of columns tu the buttertly 
switch, Lt must be elther two or three, The default, if 


this command $3 not present, 13 two columns. 


Switch req, 


The *switehtreg™ Command takes one argument, 4 declinal 
number. This ts the frequency, fn megaHertz, of the 
butterfly switch, It must be an even number in the range 
le-5u. The default, if this Command 3 not present, 13s 48 
MHz. (This range ts for testing and does nut tmply Chat 
ation at al} such speeds 13 supported or will work 
correct ly.) 


| 
| UBout File 


The "uboottile™ command Cakes one argument, a filename for 
a file on the TCS master’s disk. This tile will be run 

on wach node which ts mentioned in the SLOTCEG.TCS tile and 
which 13 not disabled by a "disabledvards™ comunand, 
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SP RVICES: 


This section lists the services that the TCS Master 
provides to the operating system or diagnostic programs 


running on the BF2, It describes the commands ty be ylven to 


the TCS master and describes the responses that will be 
generated. 


[AL this writing, services numbered 40 through 4D (those 
dealing with DOS files) have not been implemented. } 


Service summary: 


Code Meaning 

oo No command 

lu Set desired state of component 
nM Read current state of component 


Shutdown system 
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' REQUEST PROTOCOL, ARGUMENTS AND RESULTS 


ED Reboot system, counting panics 
va ketead configuration tlles 

28 Get current: boot string 

ar Set buot string P 
25 Get bootstrap varlable 

26 Set bootstrap vatlable 

dt Keau TCS Master’s calendar clock 
8 net TCS Masters calundar clock 
2. Exit) (return to TEX prompt) 

oA Warm boot a ode 

26 Cold Bout a node 

40 Open DOS tile for reading 

al Open DOS thle for weiting 

id Open DOS file for appending 

43 Seek read tile 

aa Seek write tlle 

a5 Read 

40 Wiite 

47 Close read tile 

48 Close write tile 

ay Delete bUOS file 

4a Mkdir 

4B Radi 

4c Connect to directory 

aD Get current directory 

80/81 Read/write action register 
@2/83  Read/write EEPROM register 
84/85 Read/write Gate-Array register 
86/87 Read/write hardware register 
88/89 Read/write T-Bus location 


‘he following sections describe the Services in more detall. 


The "code" for each command is a one-byte HEX number which the 
VCS reads from location to tcs cmd in paye zero, A suyyested 
mncmonic 13 shown. 


The argument area and response area are described for each 
command. The arguments are read trom physical memory poloted 
to by to tes args in page zero. The arguments themselves way 
or may not be in page zero. Similarly, the results are 
returned into a physical memory area pointed to by 

from tcs response. The argument and response areas must each 
be word-aligned. 


The results are valid when the TCS clears to tes cmd, 
Immediately after clearing the command byte, the TCS will 
assert FROM TCS SRV DONE in from tcs bits. If an error 
occurs in processing the request, FROM TCS SRV ERK will also 
be set (simultaneously), The will then cause an 
Interprocessur Interrupt if TO TCS SRVKEQ INT EN 13 set in 
to_tes bits, 


Values tor Ube atyument and response items are detalled at the 
end of this document. 


BOOTSTRAP VARIABLES 


The TCS maintains a bluck of sixteen Je-bit variables for use 
by the operating system and its buotstrap. These can be 
trom the BOOTCEG,TCS rile and can be set and yotten by 
service requests. 


These vatiables are meant as non-volatile memory over the 
process of booting or re-buoting the operating system. 


The TCS assigns meaning to variables number zero and one, the 
current panic count and panic limit, (See discussion under 
SVU_REBOOT.) The remaining varlables are uninterpreted by the 
TCS. 


The TCS also maintains one string, the *boot string", 
in the same way. This string ts typically 

= (xy0, 0,0) /vmunix* 
The current string will have been read from the BOOTCFG.TCS 
file or from a SVC WRITE BOOTSTRING command, The string 
may be up to 127 characters long and ts null-terminated. 


FILESYSTEM SERVICES 
[These services are not yet tmplemented.] 


The TCS will provide the operating system with the abliity to 
twad one DOS file and simultaneously to write one DOS tile. 
The TCS will not allow writes or appends to already-extsting 
Liles with the DOS attributes "read-only", “system™ or 
“nidden". Other than this restriction, the TCS dues NOT 
protect itself from these file operations, The operating 
system can, 1f it wants, destroy anything on the TCS’s disk. 
These functions should be used with due caution. 
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SERVICE FUNCTION DESCRIPTIONS 
| 
[Code Name Description 


00 SVC_NONE No command 


This 1s the state of to tcs cmd when no request 1s 
\ pending. 


lu SVC_SET_COMP STATE 
Set desired state of component. 


This causes the TCS to begin changing the slate of the 

i component. Since some state changes take time, such a3 

tunning the microboot, the final state will not be seen 
Jumedtately. 


Arguments are: 


byte 0 COMPONENT CLASS 
byte 1 Unused, tor al tyniment 
bytes COMPONENT INDEX 
byte 4 COMPONENT STATE 


Resulls are: 
None. 


dt 


©_GET_COMP STATE 
Read current state of component. 


Arguments are: 
| byte 0 COMPONENT CLASS 
H byte 1 Unused, for alignment 
/ bytes 2-3 | COMPONENT INDEX 


Results ate: 
| byte 0 Nonzero if the component has 
tespunded to a TCS message 
byte 1 Nonzero If the component 1s 
"disabled" (Use: OFF) by the 
BOOTCEG.TCS file or other command 
Nonzero If the component 1s 


is 


byte 
powered on 

byte 3 Nonzero ft the component is 
wstck*; e.y., falled to respond 
correctly to mbcrobuct or POST 

byte 4 The current desired state vt 
the component . 


byte 5 Nonzero if the component has reache 
the desired slute, 


8910707 


y 
y 
y 
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bootsTRAP SUPPORT FUNCT LONS : 


VC SHUTDOWN 
Shutdown system 


Yhe TCS will begin a shutdown procedure. ALL processors 
Will be halted. If requested, a1] components will be 
powered down, The operating system should not make Chis 
request until its own shutdown process has been done and 
al] 1/0 operations ate completed. The TCS will acknowledge 
this request, giving a completion interrupt if requested, 
The actual bale will Cake place after a delay on the order 
ot a few seconds. 


Atguments are: 
byle 0 of U, turn off power. Lf non-zery, 
leave powor on after halting. 


Results are: 
None. 


‘REBOOT 


Reboot system, counting pantes 


The TCS will reset all components and reinitialize them, 
runniug Che micteboot and POST. It will then cun the 
bootstrap and reload the system. The Tes will 
acknowledye this cequest, giving a completion Interrupe 
{f requested. The actual halt will Cake place after a4 
delay on the vtder of @ few seconds, 


before restarting the system, the TCS will tocrement 
Pootstiap vattable zero, the “panic count®, and 


Will compare it to bootstrap varlable one, 

the “panic Limit*. It the count teaches the Limit, 
the system will not be relowded and the service 
request will be Created a3 a SVC_SHUTDOWN, with 
uptional power shutdown. 


beture making this request, the operating system should 
assure that the current boot string and other 
bootstrap variables have Leen passed Co the Te: 

The operating system should not wake this request until 
it has finished its own shutdown process and all 1/0 
operations have been completed. 


Arguments are: 
Byte 0 Meaningful only If the *panto Limite 
{gy reached, Then, if 0, turn off 
Zero, leave power on 


power. Tf tut 
after halting. 


Results are: 
None. 


SVC_REREAD CONFIG 
Reread configuration tiles 


The TCS will reread the configuration tiles, bOOTCRG, TCS 

and SLOTCFG.TCS. This will override any parameter changes 
that may have been made since they were Last read. 
vperating system may then choos: 
the varatelers and request a rebvot. 


he 
tu change @ subset of 
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Arguments are: 
None. 


Kesults ate: 
None. 


SVC_GET_bOOTSTRING 
Get current Loot string 
The TCS will write the current boot string into the 
result atea, The string may be up to ly characters 


Jong and ts nuli-verminated. 


Arguments are: 
None. 


Results at 


The string, starting at byte zero, 


SVC_SET bOOTSTKING 
Set bout string 


The TCS will read a string from the argument area snd 
hold It as the current boot string. The string may be up 
to 127 characters long and fs wull-terminat.d. This 
string will generally have been read trom BOUTCEG.TCS, 
but may be overridden by this function, This does NOT 
change the varlable in the BOOTCEG.TCS Elle. 


Arguments are: 
The string, starting at byte zero. 


Results are: 
None. 


SVC_GET BOOTVAR 
Get bootstrap variable 


The TCS will copy the requested 32-bit boot strap 
vartable into the result area. 


Arguments are: 
Byte 0 The number of the desired varlable, 
zero through fifteen. 


Results are: 
Bytes 0-3 The variable 
SVC_SET_ BOOTVAR 
Set bootstrap variable 


The TCS will read the variable from the argument area. 
This does NOT change the variable in the BOOTCFG,TCS 
tile. 


Arguments are: 
Byte 0) The number Of the desired variable, 
zero though fifteen. 


lgnored (tor word alignment) 
The variable. 


Bytes 1-3 
bytes 4-7 


Results are: 


None. 


) SVC_GET CALENDAR 
Get calendar/clock Suto from TCS master 


The TCS reads the current date and time from DOS. 
This number will have been set by DOS at TCS 
startup time from tts onbeard battery-backed 
clock. 


Arguments are: 
None: 


Results are: 
bytes 0-3 a 32-bit number, the number 
ot seconds since 00:00:00 
vt January 1 1970, GMT. 


yo SVC SET CALENDAR 


Set TCS master’s calendar 


lock Into 


The TOS sccupts a date and thue fr 


the argument 
dtea and places them tnt DOS and Into the 
battery-backed clock. 


Arguments ate: 
Bytes 0-3 4 SO-bdt number, the number 
vt seconds since 00700700 
on January 1 1970, GAT. 


Kesulls ate: 
None: 


4 sve EXET 
Exit from appd teat bu 


Arguwents ater 
bytes U-$ a S2-bdt number 


This service causes TEA Co Lype eres: Exit." and then 
to return to dts command prompt (as ff the operator 
had typed "'."). It ty provided a3 a less drastle 


halt than SVC KEBOOT or SVC SHUTDOWN, 


It the argument $3 won-zeru, 1s value ts also 
printed. 


2A SVC_WARM BOOT NODE 
Reboot the specified node. 


This causes the TCS to halt the specified node, reload and 


start the micreboot fn its wait loop. 


Atguments are: 


byte v COMPONENT CLASS [Must be 4 procesur) 
byte 1 Unused, for alignment 
bytes 2 COMPONENT INDEX 


Kesults are: 
None. 


This tunction will tall it the node Calhut be ceessed ut 


it the microboct cammet be lvaded. Tt does NO’ walt 


the microboot to enter its idle loop. 


'26 svcC_COLD_BOOT NODE 
| Reset and reboot the specified nude. 
| 


This causes the TCS to reset the specified node and 


restart the process of bringing the node to the 
its currently selected component state. 


Arguments are: 


byte 0 COMPONENT CLASS [Must be a procesor) 


byte 1 Unused, fur aliyoment 
bytes 2-3 COMPONENT INDEX 


Results are: 
None. 


This function will fall if the node cannot be accessed 


bos FILE FUNCTIONS: 


In the ftullowing functions, the pathname and filename 
strings must be less than 128 characters, and are 
terminated by a NULL, 


au SVC_DOS_OPENR 
Open DOS file for reading 


The TCS will attempt to open a tile for reading. 
Only one tile may be open tor reading at one time. 


Arguments are: 
byte o-n The filename string 


Results are: 

byte vu “ete fol success, non-zero 
ditions 
(values to be specified) 


tor vathous errors © 


“pos OVENW 
> pOS_OVENA 
Open DOS file tor wilting (ot appending) 


The 1 will attempt Co open a tile tur weiting. 
Only one file may be open for willing at one Chime, 
If the ...OPENA call ts used, an append will be 
done It the thle already exists. 


Arguments ate: 
Byte u-n The filename string 


Results ate: 
Byte 0 Zero for success, non-zero 
tur various errors conditions 
(values to be spect fled) 


Ai osve bos {KR 
14 SVC_DOS_SEEKW 
Seek (read of write) thle 


The TCS will perform a seek operation on the specifted 
tile. 


Arguments are: 
Bytes 0-3 The file position (byte number). 
-1 means end of tlie. 


Read from file 


The TCS will read bytes from the currently open "read™ 
tlle. The tile 1s read in binary; the string 13 neither 
null-terminated nor broken at an EOL, No conversion ts 
done between Unix newlines and DOS CR/LF palrs. 


Acgument3 are: 
bytes U-3 Maximum number of bytes to read. 
This number must be ne mere than 
120. 
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4) 
46 


ay 


4A 


Results are: 

Bytes 0-3 Number of bytes read. May be 
smaller than requested If the 
file reaches EOF. A negative 
number means an error (fle not 
open, disk error). A zero means 
that the file is at EOF. 


Bytes 4-n The data from the tlle. 


svc DOS WRITE 
Write to tile 


The TCS will write bytes into the currently open *write® 
file. The flle f3 written in binary. NULLs are not 
treated spectally. No conversion is done between 

Unix newlines and DOS CR/LF pairs. 


Arguments are: 
bytes 0-3 = Maximum number of bytes to write. 
This number must be no more than 
128. 
Bytes 4-n 9 The data to be written. 


Results are: 
Bytes 0-3 9 Nuwber of bytes weltten, May be 
swaller Uhan requested ff the 


wutput device fhlis up, A negative 


Dumber means an error (tlle not 
open, disk error). 
svc _ DOS CLOSER 
SVC_DOS_CLOSEW 
Close (read or write) file 


The TCS will close the specified file. 


Arguments are: 
None. 


Results are: 
Byte 0 Zero tor success, non-zero If 


DOS reports an error closing the tlle. 


SvC_DOS_ DELETE 
Delete file 


The TCS will delete the specified file from the DOS 
filesystem. 


Arguments are: 


Bytes 0-n The Ellename string, null Cerminated 


Results are: 
byte 0 Zeru for success, won-zeto If DOS 
reports an error. 


SVC_DOS_MKDIR 
Make a directory 


The TCS will create the specified directory In the DOS 
filesystem. 


Argqunents are: 


Bytes O-n The pathname stctng, null terminated 


Results are: 
Byte uo Zeru fur success, non-Zer if bos 
reports an error. 


aly SVC DOS _RMDIR 
Kemove a directory 


The TCS will delete the specttied directory from the DOS 
tilesystem, 


Arguments ate: 
bytes U-n Th pathname string, null terminated 


Results ate: 


byte U Zery fur success, non-zero it bos 
reports an error, 


\ pve DOD GE 


urtent directory 


The TES WiLL report the 
tilesyste 


rrent directory from the Dos 


Note that a service to CHANGE the current directory ts 
Not provided, to avold changing Co ditterent derault 
contiyguration files. 


Arguments are: 
Byte o Number of 
the string 


ailable bytes for 


Results ate: 


bytes U-n The pathname string, terminated 
by @ NULL, DOL spocdtics 


length Co be a maximum of 07 


characters Including the NULL. 

The tiest three chatacters ate the 
drive letter, a colon and a 
backslash. 
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TCS SLAVE REQUESTS 


The following functions pass requests directly to the TCs 
slave processors on the various system cards, They should be 


used with caution, after understanding the relevant TCS slave 
| 


programming specifications. 


RD ACTION 


The TCS sends an ACTION 
specified TCS slave. 


Arguments are: 
byte 0 
byte 1 
bytes 2-3 
Byte 4 


Kesults arte: 
Byte 0 


byte 1 
gl Sve Tes WR ACTLON 


Yhe TCS sends an ACTION 
specitied TCS slave. 


Arguments are: 
byte 0 
byte 1 
bytes 2-3 
Byte 4 
byte 5 


Results are: 
Byte 0 


_RD_EEPROM 


The TCS sends an EEPROM 
slave. 


byte 0 
byte 1 
bytes 2-3 
Byte 4 


| Arguments are: 
| 


Results are: 
Byte 0 


byte 1 


‘TCS_WR_EEPKOM 


The TCS sends an EEPROM 
TCS slave. 


Arguments ate: 
byte uo 
byte 1 


REGISTER read request lo Che 


COMPONENT CLASS 
Unused, tor allynment 
COMPONENT INDEX 
Action register number 


Zero for su 


ess, Mon-Zero for 
error (Wu response or NAK) 
Returned data, if successtul 


KEGISTEK wrile Lequest lo Che 


COMPONENT CLASS 

Unused, for alignment 

COMPONENT INDEX 

Action register number 

Value to be written te the register 


Zero for success, Won-Zery tot 
error (no response or NAK) 


read request to the specttied Tos 


COMPONENT CLASS 
Unused, for altgnment 
COMPONENT INDEX 
EEPROM byte address 


2ero for success, bon-Zero tor 
error (no response of NAK) 
Returned data, Lf successtul 


write request ty the specified 


COMPONENT CLAY 
Unused, for al tygument 


bytes 2-3 COMPONENT INDEX 
Byte 4 EEPROM byte address 
Byte 5 Value Lo be written to the EEPROM 


Results are: 
* Byte 0 Zero for success, non-zero for 
error (no response or NAK) 


44 SVC_TCS_RD_GATEARRAY 


The TCS sends a Gate Array register read request to the 
specified TCS slave. 


Arguments are: 


byte 0 COMPONENT CLASS 

byte 1 Unused, for alignment 

bytes 2-3 COMPONENT INDEX 

Byte 4 Gate Arttay number (Command modifier) 
Byte 5 Gate Array register number 


Results are: 


Byte 0 Zero tor success, non-zero for 
error (no response or NAK) 
Byte 1 Returned data, If successtul 


SVC TCS WR GATEARRAY 


The TCS sends a Gate Array write request to the 
specified TCS slave. 


Arguments are: 


byte 0 COMPONENT CLASS 

byte 1 Unused, for alignment 

bytes 2 COMPONENT INDEX 

Byte 4 Gate Array number (Command modi filer) 
Byte 5 Gate Array register number 

Byte 6 Value to be written to the register 


Results are: 
Byte 0 Zero for sues non-zero for 
error (Wo respon. ut NAK) 


86  SVC_TCS_RD_HWARE 


The TCS sends a HARDWARE register read request to the 
specified TCS slave. 


Arguments are: 


byte 0 COMPONENT CLASS 

byte 1 Unused, for alignment 
bytes 2-3 COMPONENT INDEX 

Byte 4 Hardware register number 


Results are: 


Byte 0 Zero for success, non-zero for 
error (no response or NAK) 
Byte 1 Returned data, if successful 


ui SVC_TCS WR_HWARE 


The TCS sends a HAKDWARE register write request to the 
specified TCS slave, 


Arguments are: 


88 


ay 


byte 0 COMPONENT CLASS 

byte 1 Unused, for alignment 

bytes 2-3 COMPONENT INDEX 

Byte 4 Hardware register number 

Byte 5 Value to be written to the register 


Results are: 
Byte 0 Zero tor success, non-zero tor 
error (no response or NAK) 


svc TBUS RD 


T-Bus read cycle 


The TCS sends a TCS T-Bus memory setup request 

and a T-Bus memory read request to the specified 
TCS slave. The requestor MUST correctly format all 
bytes of this message or the remote T-Bus may 

be hung. This command allows complete f1 
getting up the request, and does no validity checking. 


Arguments are: 


byte 0 COMPONENT CLASS 

byte 1 Unused, for al lynment 
bytes 2-3 | COMPONENT INDEX 

Byte 4 Memory setup CMD MOD byte 


(SIGA A/B selector) 


byte 5 Memory setup TBus Command 
byte 6 Memory Setup TBus CMOD1 

byte 7 Memory Setup TBus CMODO 

byte & TBus Read CMD MOD (increment) 
byte 9-11 unused, for allynment 


bytes 12-15 TBus address bits 31-0 


kesults are: 
Byte 0 Nack or Ack code from slave 
Byte 1 TBus response byte 
Bytes 2-3 unused, for alignment 
Bytes 4-7 Data from TBus cycle 


SVc_TBUS WR 


T-bus write cycle 


The TCS sends a TCS T-Bus memory setup request 

and a T-Bus memory write request to the specified 

TCS slave. The requestor MUST correctly format all 
bytes of this message or the remote T-Bus may 

be hung. This command allows complete freedom tn 
setting up the request, and does no validity checking. 


Arguments are: 


byte 0 COMPONENT CLASS 

byte 1 Unused, for alignment 
bytes 2-3 COMPONENT INDEX 

Byte 4 Memory setup CMD MOD byte 


(SIGA A/B selector) 


Byte 5 Memory setup TBus Command 
byte 6 Memory Setup TBus CMOD1 

Lyte 7 Memory Setup TBus CMODO 

byte 6 TBus Write CMD MOD (increment) 


byte 9-11 unused, for alignment 
bytes 12-15 TBus address bits 31-0 
bytes 16-19 TBus write data 


Results are: 
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byte 0 Nack or Ack code from slave | 
Byte 1} TBus response byte |values of argument and response bytes; 


Note that these numbers are not simply hardware card types 
but are "functional® classes. These correspond more closely 
to locations within the system than to types of hardware. 


| COMPONENT CLASS 
i 
| 
| 


00 TC/CLK clock card 
Ol TC/SS tn Switch A 
fl v2 TC/SK in Switch A 
03 TC/SS tn Switch B 
04 TC/SR in Switch B 
v5 TC/FR, TC/ERV or other processor node 


| COMPONENT INDEX 


This 43 the index of a particular component class. 

For clocks, the index ranges from 0 through 1, 

For switch cards, the Index ranges from 0 through 63. 

for processor nodes, the Index ranges from 0 through SIL, 


COMPONENT STATE 


| This argument {3 used fn the SVC SET COMP STATE request. 
' This 13 an overal] state of a component, It hides many 

' other more detalled states which may change with verstons 
of the software. The states are analogous to thuse 
specified by the *NodeUse* Iine tn the BOOTCFG 3 

file and the *Configuration Card-Use® commane 


The operating system may request that Che component’ be 
placed In one of the following four states: 


v1 svce_CS SYS System usage 


> CS_AUX Auxillary usage 
03 SVC _CS_ISOLATE Isvlated usage 


j 04 svc_cs_oFF Off, or disabled, usage 
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